home *** CD-ROM | disk | FTP | other *** search
/ PD ROM 1 / PD ROM Volume I - Macintosh Software from BMUG (1988).iso / Desk Accessories / Graphics / DAfx / DAfx-READ ME! (1.20) < prev    next >
Encoding:
Text File  |  1988-02-20  |  19.3 KB  |  355 lines  |  [TEXT/MSWD]

  1. DAfx 1.11 - 1.20 Release Notes 2/20/88
  2. [Font: Monaco 9 point.  Tabs set at 4]
  3.  
  4. This file contains bugs and changes that are not noted in the documentation.
  5. It is EXTREMELY IMPORTANT that you read about using version 1.11 with
  6. MultiFinder.  If you don't, it is likely that DAfx will "hang" the computer 
  7. (losing all work not saved in other applications).
  8.  
  9. ***    DAfx 1.10 Bugs
  10.  
  11. *    Double clicking the eraser tool to erase the current drawing area
  12. does not set the "changed" flag.  Meaning that if a new picture is opened
  13. or created and only the drawing area is erased, opening a picture or
  14. creating a new picture again will NOT bring up the "Save Changes" dialog.
  15. (fixed in 1.11)
  16.  
  17. *    The first paragraph describing the preferred customer package (in the
  18. text registration form that was "stuffed" with DAfx 1.10) contains some
  19. invalid information that shouldn't have appeared.  The documentation and
  20. the registration form stuffed with DAfx 1.20 contains the correct version. 
  21. (MS Word strikes again!)
  22.  
  23. ***    DAfx 1.11 Features: (These apply to 1.12 & 1.20 also)
  24.  
  25. *    Version 1.11 now works with MultiFinder.  It hasn't be extensively tested,
  26. but if the following precautions are followed, there is a very low risk of
  27. failure (BOMB!).
  28.     
  29.     -    The most important thing to do when opening DAfx in MultiFinder is to
  30.         HOLD DOWN THE OPTION-KEY while selecting "DAfx" from the Apple menu.
  31.         This will load DAfx into a different area than "normal".  Usually when
  32.         DAs are opened in MF, they are lumped into an area controlled by the 
  33.         "DA Handler" that comes with MultiFinder.  This area is too small for
  34.         DAfx to operate and the system can BOMB in a matter of minutes if DAfx 
  35.         is continued to be used.  (This "DA area" is signified by the little
  36.         suitcases in the upper right-hand corner of the menu bar.)
  37.             If DAfx is opened while holding down the option-key, it is loaded
  38.         into the Finder's memory area, just as if it had been opened without
  39.         MultiFinder running.  Because of this, it is recommended that DAfx
  40.         be opened only after ALL OTHER APPLICATIONS have been opened.  This
  41.         lets the applications have the first grab at memory.  (The "little Mac" 
  42.         will be displayed in the upper right-hand corner of the menu bar.)
  43.  
  44.     -    Because memory is hard to come by under MultiFinder, version 1.11 also 
  45.         has a new menu item under the Apple menu.  It's called "What's Up 
  46.         Doc?..." and it will bring up the "Inside Macintosh" dialog.  This 
  47.         dialog lists the amount of free memory in the various areas of the 
  48.         Macintosh.
  49.         +    The first item in the dialog is "Free Memory" which displays the 
  50.             amount of free memory in the "Application Area" (the memory area 
  51.             where applications are loaded, normally called a "heap").  This 
  52.             actually represents the largest contiguous "block" of memory that's 
  53.             available.  It's possible that more memory is available than the 
  54.             number represented here.  An acceptable value is more than 20K of 
  55.             free memory.  (If MultiFinder is running, this will represent the 
  56.             amount of free memory in the Finder's memory area.)
  57.         +    Next is the "Stack Space" that displays the amount of memory 
  58.             available on the "stack", which is an area of memory that is the 
  59.             heart of the Macintosh.  If the stack runs out of memory, the Mac 
  60.             dies (bombs)!  There should be at least 6K of stack space.  If not, 
  61.             close DAfx IMMEDIATELY!
  62.         +    Then there's the "MF Memory" which displays the amount of memory 
  63.             that's available in MultiFinder's temporary memory area.  This 
  64.             area is for large temporary memory usage by all applications 
  65.             running under MultiFinder.  The Finder uses this area to copy 
  66.             files, for example.  There should be 30K or more in this area 
  67.             before becoming worried.
  68.         +    The last item on the dialog is the "Condition" of DAfx.  This will 
  69.             display one of four available messages on what DAfx thinks about 
  70.             the current memory conditions.  They are:
  71.  
  72.             "OK!" is displayed if DAfx has plenty of memory to run normally.
  73.  
  74.             "Getting Tight" means that the amount of free memory isn't in 
  75.                 great abundance.
  76.  
  77.             "CLOSE DAfx NOW!" means that DAfx should be closed at once with no
  78.                 questions asked.
  79.  
  80.             "HIT THE DIRT!" isn't a good sign.  If this message is displayed,
  81.                 chances are that the Macintosh will bomb upon leaving the 
  82.                 dialog or shortly thereafter.
  83.  
  84.             Click the OK button to return to DAfx.
  85.  
  86. *    DAfx always had a memory alert condition where it will display a 
  87. shortage of memory dialog if there is less than 20K of available memory.  I 
  88. personally hadn't seen this dialog for about 6 months, until I ran DAfx inside 
  89. MultiFinder.  DAfx will display a dialog that memory is getting sparse if 
  90. there is less than 20K available.  If MultiFinder is running, you should 
  91. close DAfx immediately.
  92.  
  93. *    To be on the safe side, DAfx 1.11 now monitors the available "stack space" 
  94. (described above).  You will also get a dialog stating that DAfx should be 
  95. closed immediately if the stack space is less than 6K.  (This is why it is 
  96. extremely important that DAfx be opened with the Option-key in MultiFinder.  
  97. If the Option-key is not held down, DAfx is loaded in a tiny area that gives 
  98. it about 3K of stack space.  Meaning that it's opened with an extremely 
  99. dangerous small amount of stack space!!)
  100.  
  101. *    Because of the possibility of opening DAfx 1.11 without the option-key in 
  102. MultiFinder, DAfx will refuse to open if there is less than 6K of stack space.
  103.  
  104. *    The DAfx window also knows if MultiFinder is running.  If you zoom to full 
  105. screen and MultiFinder is running, the right-hand area of the screen will not 
  106. be covered.  But the window can still be changed to the full screen using the 
  107. "pop & size" window control.
  108.  
  109. These conditions were all tested on a 1MB Mac Plus.  If you have more memory 
  110. and/or are experiencing some problems with DAfx and MultiFinder, please notify 
  111. me immediately!
  112.  
  113. ***    DAfx 1.12 Features (1.20 too)
  114.  
  115.     DAfx 1.12 includes a complete "FatBits" environment for pixel-by-pixel 
  116. editing of pictures.  There are two ways to invoke FatBits: one is to click
  117. the Magnifying Glass tool in the tool palette or you can select "FatBits"
  118. from the Goodies menu.  Both methods activate FatBits in exactly the same
  119. way.  But if the Tool Palette is hidden, it's easier to select FatBits from 
  120. the menu.
  121.     After FatBits is activated, the window will change into FatBits "mode". 
  122. The most obvious way to determine if FatBits is active is by the window 
  123. display.  It can also be determined if FatBits is active by seeing if the 
  124. "FatBits" item in the Goodies menu has a check mark next to it or if the 
  125. Magnifying Glass tool in the tool Palette is highlighted.
  126.     When FatBits is active, there will be two drawing areas shown of
  127. different sizes.  The area on the left-hand side of the screen is the
  128. "normal view" (what the picture looks like at "1x").  The area on the right-
  129. hand side displays the "magnified view" of the "normal view" at the current
  130. magnification level.
  131.     The normal view displays the "active drawing area" that can currently
  132. be edited.  The size of this area depends on the magnification level (ML).
  133. The higher the ML, the smaller this area will become.  DAfx automatically 
  134. figures out what the greatest viewing area can be and still display the
  135. entire magnified view in the window.  Therefore, the larger the window size,
  136. the more area can be edited.
  137.     There are five levels of magnification that can be used: 2x, 4x, 8x,
  138. 16x, and 32x.  Unless you have a large screen display, 16x is the highest ML
  139. that should be used on a standard Macintosh screen (32x leaves about a
  140. 10 x 10 pixel "active area").  The current ML is always displayed in the 
  141. lower left-hand corner of the DAfx window when FatBits is active.
  142.     There are two ways to change the ML, by either using the Magnifying 
  143. Glass tool or the keyboard.
  144.     To increase the ML using the Magnifying Glass, simply click the Magnifying
  145. Glass tool in the tool palette.  It will move to the next highest ML, if there
  146. is one.  Holding down the Option-key while clicking the Mag. Glass tool will
  147. use the previous ML, if there is one.
  148.     If the Tool Palette is hidden, you can change the ML by using the 
  149. keyboard.  Pressing the "+" (plus) key will increase the ML, and the "-" 
  150. (minus) key will decrease the ML.  The "=" key can also be used to increase 
  151. the ML, so it isn't necessary to hold down the shift key.  And, if the shift-
  152. key is accidently held down while pressing the "-" key, the "_" (underscore) 
  153. key will also decrease the ML.  The "+" and "-" keys on the numeric keypad 
  154. can be used too.
  155.     Now that we know how FatBits looks, lets find out how to use it!  When
  156. the mouse (cursor/pointer) is moved into the "normal view" area, it will 
  157. change to the hand cursor.  Dragging the mouse while in this area will move
  158. the picture and it works exactly the same as before (auto-scroll/turbo mode,
  159. etc.).  The "magnified view" area is also refreshed during the movement so you 
  160. know exactly where you are.  If the mouse is moved into the "magnified view"
  161. area, it will change into the pencil tool.  If the mouse is dragged at this
  162. time, drawing will begin and all changes are immediately reflected in the
  163. "normal view" area.
  164.     It may not be surprising, but DAfx is different from "other" FatBit modes.
  165. Maybe it should have been called "FatLine" mode?  Because you don't simply 
  166. toggle pixels on and off, you can actually draw lines!  In fact, ALL the 
  167. features of the Pencil tool are available in FatBits mode.  Such as the pen 
  168. size, paint pattern, paint mode, shift-key, and double-click features!
  169.     And because you can fly across the picture if the "turbo" grabber is
  170. active, holding down the Space-bar while in the "magnified area" will change
  171. the cursor into the hand.  But moving the picture in this area will override
  172. "turbo" mode and the picture can be moved with greater control (try it in
  173. 32x mode and see for yourself!).
  174.  
  175. *    FatBits Nitty Gritty:
  176.  
  177.     As for undoing any changes in FatBits mode, the same undo rules apply
  178. as before.  Such as using the "Use Screen" for the undo buffer and activating
  179. other windows or the "pop & size" window control.  The "Use Hard Disk" works 
  180. as it should too.  You can edit in FatBits, deactivate FatBits mode, move the
  181. picture, open other windows, activate FatBits again, and still undo the LAST
  182. FatBits change.  (Every mouse-click with the Pencil tool in the "magnified
  183. area" is considered a change.)
  184.     DAfx only supports the pencil in FatBits mode at this time.  If any of
  185. the other tools are selected in the Tool Palette or a Paste is performed or
  186. the Invert menu item is selected; FatBits will be deactivated.  And as a 
  187. safety precaution, double-clicking the eraser tool while in FatBits will 
  188. deactivate FatBits, but it WILL NOT clear the active drawing area.  Instead,
  189. the Pencil tool is activated.  This prevents the accidental erasure of the
  190. "normal" drawing area (which can be much larger than the FatBits viewing 
  191. area).
  192.  
  193. *    Also note that the grids DO NOT WORK while FatBits is active, even if
  194. "Draw with free-hand tools" is active in the Grids dialog.
  195.  
  196. *    When FatBits is activated, the default magnification level is 2x.  There
  197. currently is no way to override this.
  198.  
  199. *    When using different paint patterns in FatBits mode, it's more apparent
  200. that the patterns in DAfx do not exactly line up when the picture is moved.
  201. This isn't the case when the picture is moved with the "turbo" grabber.
  202.  
  203. **    Other improvements    **
  204.  
  205. *    Fuzzing:  The performance of the Fuzz effect have been increased 3 & 2/3
  206. times!  The benchmark of the old Fuzz took 2 minutes and 45 seconds to fuzz 
  207. the DAfx window at its original size (after opened on a standard Mac screen).
  208. The optimized version took only 45 seconds!  (Your results may vary because 
  209. the time depends on the size of the selection and the complexity of the
  210. picture.)
  211.  
  212. *    Pencil/Eraser Tools:  The performance of these tools has also been
  213. improved.  Curves can now be drawn smoother because of the increased
  214. response time.
  215.  
  216. *    DEGAS NOTE:  Beginning with DAfx 1.12, there is no longer a size 
  217. restriction on ANY of the DEGAS formats.  Therefore, only the file name
  218. extensions of ".PI1", ".PI2", and ".PI3" will be recognized.  This doesn't
  219. mean to go out and open a bunch of junky files, as this hasn't been
  220. extensively tested!
  221.  
  222. ***    DAfx 1.20 Features
  223.  
  224.     DAfx 1.20 introduces the Lasso tool, which makes the tool palette complete
  225. and working.  The Lasso tool works pretty much the same as in other paint
  226. programs except for its appearance on the screen.  Most programs draw a 
  227. rotating outline of the lassoed object.  But due to memory requirements, DAfx
  228. only draws a selection rectangle around the lassoed object.
  229.     When the Lasso tool is active, the cursor changes into a lasso when it
  230. is moved into the active drawing area.  Dragging the mouse at this time will
  231. form a area that is made up of all mouse movements until the button is
  232. released.  This area must be a closed loop, so when the mouse button is
  233. released, the ends are joined no matter where they are in the drawing area.
  234. Notice that the lasso tool draws with a "gray" outline.  This allows you to
  235. track the mouse movement over black areas.
  236.     After the "Lasso area" is formed, the outline is erased and the selection
  237. rectangle will encase it.  When the mouse is moved into the lasso area
  238. (selection rectangle), the cursor changes into the "four-leaf-arrow" cursor
  239. signifying that it can be moved if the mouse is dragged at this time.  Moving
  240. a lasso selection is the same as moving a "pasted selection".  The auto-scroll
  241. and the Option-drag act the same way (Option-drag will "stamp" a image of the
  242. selection at its current location).
  243.     
  244. ** Other Lasso Tricks:
  245.  
  246. -    DAfx may be the only program that allows you to lasso an object that is
  247. contained on a black background.  This is accomplished by either holding down
  248. the Option-key while forming the "lasso area"; or it will happen automatically
  249. if the "Black Background" is selected in the preferences dialog (the Option-
  250. key has no effect on the latter case).
  251.     [What this means is that most programs usually look for a black edge to
  252. "bump up against" when forming the lasso area.  This is fine if the object is
  253. on a white background.  But if the object is on a black background, the lasso
  254. formation immediately bumps up against the black background.  Thus ignoring the
  255. object within the lasso area and leaving a black border around the edge of
  256. the object.  Using the above methods, this problem is totally eliminated.
  257. Notice that holding down the Option-key or having "Black Background" enabled
  258. while lassoing an object on a WHITE background will have the above mentioned
  259. problem (but with a white border around the object instead of black).]
  260.     If you activate the Selection tool while a lasso is active, the lasso area
  261. will be converted to a normal selection.  Note that this is the only way to
  262. use the "F/X" menu items (except invert) on the lasso area.  If the Lasso
  263. tool is selected and a "normal" selection was active, the selection will
  264. be converted into a lassoed selection (the Option-key and Black Background
  265. settings are used while doing this, as mentioned above).
  266. -    Note that switching between a lassoed selection and any normal selection
  267. behave this way.  Such as switching from a rotated selection and pasted
  268. selection.  DAfx does not support PASTED lasso selections.  Therefore,
  269. selecting the lasso tool after a paste is the easiest way to simulate that
  270. type of operation.
  271. -    DAfx, however, DOES support lasso COPIES to the clipboard.  That is,
  272. when a lassoed area is copied to the clipboard, it will be treated as a
  273. lassoed object in other paint applications or any application that supports
  274. the "MacPaint Lasso".  (Note that a "lassoed object" can only exist if the
  275. application that it is pasted into supports them.  Also note that copying
  276. a lassoed object can only be performed if DAfx is unlocked.)
  277.  
  278. -    The Invert operation in the "F/X" menu behaves differently with the Lasso
  279. tool than might be expected.  The Invert option will invert the "lassoed area"
  280. of the current lassoed selection.  This "effect" can come in handy sometimes
  281. and it can be used to achieve some special "f/x".
  282.  
  283. -    Also notice that the lasso selection outline rotates in the same direction
  284. as a "pasted selection" does (left and up).
  285.  
  286. **    Also new to version 1.20
  287.  
  288. *    The "turbo grabber" is even faster.  You might say it is "fuel-injected"
  289. now!  It may be the fastest grabber on the planet, because it can move the
  290. picture from the top to the bottom before you can say "Mac".
  291.  
  292. *    The "jitters" that where a side-effect of the "turbo grabber" have been
  293. eliminated.
  294.  
  295. *    The "New" menu item in the File menu will erase the entire picture to
  296. black if the "Black Background" option is enabled in the preferences dialog.
  297.  
  298. *    A new feature in the "Preferences" dialog is called the "Option-Fuzz 
  299. Threshold".  It is a editable text box where a number from 0 - 15 can be
  300. entered.  This number sets the "threshold" or cut-off point for the Option-
  301. Fuzz effect (achieved by holding down the Option-key while selecting Fuzz).
  302. The lower the number, the darker the selection will be fuzzed.  The higher
  303. the threshold, the brighter the  selection is fuzzed.
  304.     Entering a "1" (the default until saved) makes the Option-Fuzz effect behave as it did in previous versions.  The thresholds from 2 to 8 can
  305. be used to darken or lighten digitized images.  The results depend upon how
  306. dark the image was digitized (or scanned).  Using these thresholds (2-8)
  307. can also be used to strip gray-scale patterns from images!  This new
  308. threshold setting opens up infinite possibilities.  I haven't even had the
  309. time to test them with the seven other paint modes!  Have fun and explore!!
  310.     [Note that the preferences settings for version 1.20 will continue to
  311. use the default settings until they are saved to replace the old 1.1x
  312. settings.]
  313.  
  314. *    New in the File menu: Print Registration Form.  Selecting this option
  315. will print the registration form to a DIRECTLY CONNECTED IMAGEWRITER OR
  316. EQUIVALENT.  You will be warned before printing the form and you can
  317. cancel the operation if needed.  This means that you can't print it to the
  318. LaserWriter or other AppleTalk output device.
  319.  
  320. *    The Undo edit item has been unlocked permanently.  Now you can undo your
  321. changes even if DAfx is locked.
  322.  
  323. *    I think it's documented, but when "Use Application Menus" from the
  324. Apple menu is used, clicking anywhere in the DAfx window will re-activate
  325. the DAfx menus.  They can also be re-activated by selecting "DAfx" in the
  326. Apple menu (after the application menus are displayed), beginning with version 1.20.
  327.  
  328.     That's it!  I hope!?  Don't be surprised if you come across some
  329. undocumented features.  They are added almost daily and it's hard to keep
  330. track of all of them.  Please let me know if you find one so we can let 
  331. others know too!
  332.     Also, THIS MARKS THE END OF THE DAfx version 1.xx series!  (Unless some
  333. major bug is found.)  Version 2.00 will soon be underway and will have
  334. many new and exciting features.  Got a suggestion?  Get it in now!  And if
  335. you're contemplating signing up for DAfx, you had better do it soon!  Effective
  336. with the 2.00 release, there will be a price increase of all packages.
  337. (Current preferred customers are locked in until the color version.  Which
  338. implies that version 2.00 WILL MOST LIKELY NOT HAVE COLOR.)
  339.     Finally, DAfx will be available on CompuServe beginning with version 1.20.
  340.  
  341. James K. Miles
  342. Mi Concepts
  343. P.O. Box 8822
  344. Kentwood, MI  49508
  345.  
  346. CIS:    [71121,3421]
  347. GEnie:    jmiles
  348. Product Support: GEnie CMUG BBS: category #5, topic #103.
  349.  
  350. The dirt and grime:
  351.  
  352.     DAfx versions 1.xx were written in MPW Pascal and assembly.  Beginning
  353. with version 2.00, I hope to have DAfx completely in MPW C and assembly to
  354. reduce the size of the DA and to improve performance.
  355.